Welcome to the Apple Color OneScanner and Scanner Driver 3.0!
This Read Me file contains information about the Apple Color OneScanner and Scanner Driver 3.0 features or behavior that are of special note or are not in the documentation, "Programmer's Guide to Apple Scanners, Second Edition" also contained on the Developers' CD.
SCANNER DRIVER 3.0 INSTALLATION
Remove all previous versions of the Scanner Driver from the Extensions and System Folder.
To install Scanner 3.0 on System 7.0 or higher, drag copy Scanner 3.0 to the Extensions folder of the System Folder. Restart the system.
To install Scanner 3.0 on System 6.0.7 or higher, drag copy Scanner 3.0 to the System Folder. Restart the system.
APPLE COLOR ONESCANNER BACKWARD COMPATIBILITY WITH THE APPLE ONESCANNER
There are some differences between the Apple Color OneScanner and the Apple OneScanner:
• Half-toning is not supported in the Apple Color OneScanner,
• The Apple Color OneScanner returns in ScStdFeaturesRec scannerType equal to 'APLC'; the Apple OneScanner returns scannerType equal to 'APL8',
• The Contrast parameter is set opposite in the Apple Color OneScanner. On the Apple Color OneScanner increasing the value of the contrast parameter decreases the contrast level, and decreasing the value of the contrast parameter increases the contrast level. On the Apple OneScanner this control is opposite.
NOTES FOR PROGRAMS USING SCANNER 3.0
•The files within the interfaces folder provide function, constant, and data structure definitions.
•Each ScDoScan call should request to read greater than one scan line as described in the "count" parameter.
•For Apple Color OneScanner units with ROM 3.00, Scanner Driver 3.0 does not report status code scDimLampErr.
•For Apple OneScanner units with ROM 2.03 or earlier, an intermittant problem may be seen when scanning a small scan area whose width is 2.13 inches or less. This problem can be avoided by setting the width to a value larger than 2.13 inches.
NOTES FOR PROGRAMS USING SCSI COMMANDS
If your Apple Color OneScanner contains either ROM 3.00 or ROM 3.01:
• Due to a problem with SCSI Manager on the Quadra 700 and 900, the SCSI Abort message should not be used to abort a command. Instead, a SCAN command with a Transfer Length equal to 0 should be used to abort a scan operation. (See also the Programmer's Guide to Apple Scanners, Second Edition).
• During the scan loop, your program should avoid sending any commands except READ, GET DATA STATUS, INQUIRY, REQUEST SENSE, SCAN with a Transfer Length of 0, and SCAN with a Transfer Length of 1, before the last GET DATA STATUS command in the scan loop.
If your Apple Color OneScanner contains ROM 3.00:
• When the Sense Key equals 9 and either the Dim Light, No Home or Over Light error bit is set in Byte 18 or 19 in Request Sense, ROM 3.00 does not return a Check Condition status for any SCSI command sent. However, the Amber LED flashes to indicate that there is a problem with either the scanner's lamp (Dim Light), the scanner's carriage is unable to locate the home position mark (No Home), or the lamp is too bright for normal scanning (Over Light). (See also the Programmer's Guide to Apple Scanners, Second Edition, SCSI Commands for Apple Scanners, REQUEST SENSE Return Structure Description for the Color OneScanner.)
• If the CPU is rebooted in the middle of a scan operation, ROM 3.00 does not respond to the SCSI Reset command that is sent to it.
• If the SCSI ID of the Apple Color OneScanner is set to 8 (used for testing purposes only) and a hardware problem is detected, the Amber LED does not flash.
